DBMS Migration Tool 사용 가이드
1. 개요
해당 Tool은 JDK1.8 기준으로 개발되어 있으므로, JRE 1.8에서 구동해주시길 바랍니다.
※ CUBRID의 경우 서버에 설치되어 있는 CUBRID의 버전과 jdbc 버전이 동일해야 동작함.
따라서 버전에 맞는 jdbc 라이브러리를 DBMSMigrationTool_lib에 넣고 실행해야함.
※ 커스텀된 table 및 컬럼은 지원이 안되므로 별도로 수작업 해야 합니다.
쿼리를 수정하거나, 대상 DBMS에서 테이블 수정 및 컬럼 수정하세요.
※ 버전 차이나는 테이블에 대해서는 오류가 발생 할 수 있습니다. 따라서 수동 마이그레이션 진행이 필요합니다 (예.pcdevicelog_info)
※ DBMS 툴에서 메모리 부족으로 인해 최대 INSERT문 개수는 5만개로 제한합니다.
※ 테이블의 IDX가 자동 증가인 경우 원본 DBMS에서 해당 옵션이 있는 경우 자동으로 입력되어서 쿼리가 생성됩니다.
기존에 데이터가 있는 경우 중복이 될 수 있으므로, 내용 확인 바랍니다.
MSSQL
시작점에 SET IDENTITY_INSERT " + tableName + " ON;이 추가됩니다.
종료지점에 SET IDENTITY_INSERT " + tableName + " OFF;가 추가됩니다.
※ 테이블의 데이터 중 특수기호가 있어 오류나는 경우
ORACLE
시작점에 SET DEFINE ON;가 추가됩니다.
종료지점에 SET DEFINE OFF;가 추가됩니다.
DBMS Migration Tool 다운로드 : DBMS Migration Tool.zip
- Linux
- Windows
2. Linux에서 추출 방법
2.1. DBMS_Migration_Tool.zip 파일을 압축을 해제
- DBMS_Migration_Tool.zip 파일압축 해제 하여 tar.gz 또는 tar로 만들어도 무관합니다.
2.2. DBMS_Migration_Tool 폴더를 서버에 업로드
2.3. DBMS_Migration_Tool 실행
java -jar /업로드위치/DBMS_Migration_Tool/DBMS_Migration_Tool.jar
/JAVA가 설치된경로/bin/java -jar /업로드위치/DBMS_Migration_Tool/DBMS_Migration_Tool.jar
/SCI Server설치경로/jre/bin/java -jar /업로드위치/DBMS_Migration_Tool/DBMS_Migration_Tool.jar
2.4. 원본 DBMS정보 및 대상 DBMS 정보 선택
2.4.1. 원본 DBMS 선택 (1~4번 입력 후 엔터)
2.4.2. 원본 DBMS의 IP 입력
2.4.3. 원본 DBMS의 PORT 입력
2.4.4. 사용자 정보 입력 (ID, PW)
2.4.5. 원본 DB명 입력 (대소문자 구분x)
2.4.6. 대상 DBMS 선택 (1~4번 입력 후 엔터)
2.5. 원본 DATA 추출
2.6. 실패시 에러 log 확인가능 (PORT 틀렸을 경우)
2.7. DBMSMigrationTool성공시 jar파일 위치에 "원본DBMS명_to_대상DBMS명" 디렉토리 생성됨.
2.8. "원본DBMS명_to_대상DBMS명" 디렉토리 내 SQL파일 생성됨.
2.9. 테이터가 5만건 이상인 경우 SQL파일이 분할되어 생성됨.
2. Windows에서 추출 방법
2.1. DBMS_Migration_Tool.zip 파일을 서버에 업로드 및 압축 해제
2.2. DBMS_Migration_Tool 실행
- SCI Server 가 설치된 폴더에서 실행이 가능합니다.
- 글자가 깨지는 경우 옵션(-Dfile.encoding=UTF-8) 추가 합니다.
java -Dfile.encoding=UTF-8 -jar DBMSMigrationTool.jar
2.3. 원본 DBMS정보 및 대상 DBMS 정보 선택
2.3.1. 원본 DBMS 선택 (1~4번 입력 후 엔터)
2.4.2. 원본 DBMS의 IP 입력
2.4.3. 원본 DBMS의 PORT 입력
2.4.4. 사용자 정보 입력 (ID, PW)
2.4.5. 원본 DB명 입력 (대소문자 구분x)
2.4.6. 대상 DBMS 선택 (1~4번 입력 후 엔터)
2.5. 원본 DATA 추출
2.6. 실패시 에러 log 확인가능 (PORT 틀렸을 경우)
2.7. DBMSMigrationTool성공시 jar파일 위치에 "원본DBMS명_to_대상DBMS명" 디렉토리 생성됨.
2.8. "원본DBMS명_to_대상DBMS명" 디렉토리 내 SQL파일 생성됨.
2.9. 테이터가 5만건 이상인 경우 SQL파일이 분할되어 생성됨.
serverprofile_info.sql파일에서 DSHeader_Key 값이 DB의 값과 동일한지 확인
- DSHeader_Key의 데이터 유형이 BINARY로 추출된 값이 @8b128dfn과 같은 값으로 sql파일에 추출되는 사례 발생
- sql파일에 DB에서 값을 복사하여 붙여 넣기 한다.
3. Import 방법
- MariaDB
- MSSQL
- ORACLE
- CUBRID
HeidiSQL툴 사용
-
HeidiSQL 실행 → DB 접속 → Target DB 선택
-
파일 메뉴 → SQL 파일 실행... → 단일(또는 다중) sql파일 선택 후 열기 → 파일을 직접 실행
COMMAND 단일 파일 실행
- mysql 실행파일을 통한 실행
- -u 사용자계정 tftdb 쿼리가 실행되는 db명 -p 실행시에 패스워드 입력받음
mysql -u 계정ID -p tftdb < 추출된.sql파일명
COMMAND 다중 파일 실행
- TFTDB디렉토리로 들어가서 실행 예
- -u실행할 계정명 -p실행시 패스워드 입력 받음 -Dsql문을 실행할 DB명
for f in *.sql; do mysql -udrmadmin -p -DTFTDB < "$f"; done
- DSLOGDB 또는 AMSDB디렉토리에서 실행시에는 -D디비명 변경 필요
관리자 툴에서 진행하는 것이므로, 관리자툴이 존재하는 PC에서 실행해야 합니다.
ssms 실행 → Target DB 선택 → 상단 쿼리 메뉴 → SQLCMD 모드 선택 → 쿼리 편집기에서 아래와 같이 명령어 입력
단일 파일 실행 명령어
:r "sql파일경로\.sql파일"
다중 파일 실행 명령어
:r "sql파일경로\.sql파일"
go
:r "sql파일경로\.sql파일"
go
파일 수량만큼 반복
sql developer 실행 → DB 접속 → 쿼리 편집기에서 아래와 같이 명령어 입력
단일 파일 실행 명령어
@"sql파일경로\.sql파일"
다중 파일 실행 명령어
@"sql파일경로\.sql파일";
@"sql파일경로\.sql파일";
파일 수량만큼 반복
CUBRID 매니저 실행 → DB 접속 → 상단 메뉴 가져오기 실행 → 데이터 파일 선택 후 sql 파일 첨부
3. dbmsMigration.properties 사용 방법
insert 쿼리 추출 시 옵션 설정 기능
#테이블 리스트 포함 여부 (Y/N)
includeTableList=N
#테이블 리스트 정보 (세미콜론으로 구분)
#tableLists=dslog_info;userlog_info;pcdevicelog_info;
tableLists=;
기본 정의된 테이블들에 대해 마이그레이션 진행
includeTableList = Y : tableLists에 나열되어있는 테이블만 마이그레이션 진행
includeTableList = N : tableLists에 나열되어있는 테이블 제외하고 나머지 전체 테이블에 대해서 마이그레이션 진행
includeTableList 항목이 없거나, Y/N이 아닌 다른값이 있는경우 : 기존과 동일한 전체 마이그레이션 진행